home *** CD-ROM | disk | FTP | other *** search
/ Box' of X 3 / Box' of X 3.iso / x-viewer / os2 / misc / os2gif.zoo / os2gif.doc next >
Encoding:
Text File  |  1989-08-08  |  8.4 KB  |  252 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.                 OS2GIF Version 1.0
  16.  
  17.  
  18.  
  19.               OS/2 NON PM GIF Display
  20.                   for EGA and VGA
  21.  
  22.  
  23.  
  24.  
  25.                 USERS GUIDE
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.                   James C. Huebsch
  38.                 [73267,1622]
  39.  
  40.  
  41.                    August  5, 1989
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.        NOTICE:     GIF and 'Graphics Interchange Format' are trademarks of
  59.          CompuServe, Incorporated. an H&R Block Company.
  60.  
  61.                OS2GIF V1.0 User Guide               Page  1
  62.  
  63.  
  64.                 INTRODUCTION
  65.  
  66.  
  67.  
  68.    OS2GIF is a NON PM OS/2 application to display GIF files on EGA or VGA
  69. video systems.    The 256 color GIF files will require a VGA adapter for an
  70. enjoyable picture.  OS2GIF supports a virtual screen larger than the physical
  71. video screen which allows panning over the image.
  72.  
  73.    The executable program OS2GIF is hereby placed into the public domain.
  74. It is "freeware" not "shareware".  No payment of any kind is requested.  If
  75. you like the program, you may send comments or suggestions for enhancements.
  76. If you find errors (bugs) you may also report them, but there is no commitment
  77. on my part to fix them or to provide future enhancements.  If no one else
  78. provides a better program for OS/2 GIF viewing I intend to enhance and
  79. continue distribution of this one.
  80.  
  81.  
  82. The OS/2 Video Environment, Now and the Future
  83.  
  84.    Currently OS/2 Presentation Manager Version 1.1 does not effectively
  85. support the 256 color mode of the VGA, this limits PM to a dithered image
  86. display.  Since many GIF files are in 256 colors, the loss of the full beauty
  87. of the colors is significant.  However OS2GIF performs direct I/O to the video
  88. adapter with OS/2 Ring 2 I/O code, providing full functionality of the video
  89. systems under OS/2.
  90.  
  91.    Also, currently OS/2 PM has performance disadvantages for image display.
  92. It is expected that these shortcomings may be addressed in future versions of
  93. OS/2, but until they are OS2GIF will not use PM.
  94.  
  95.    As video board vendors provide OS/2 PM display drivers for their boards, I
  96. expect the SuperVGA (640 x 480 x 256, 800 x 600 x 256) and better resolutions
  97. to become common for OS/2.  When IBM enters the SuperVGA market it will become
  98. a standard for video systems.
  99.  
  100.    The only video hardware I have available is IBM EGA and IBM VGA.  Due to
  101. this limitation I may not be able to support the SuperVGA boards.  However IBM
  102. compatible boards should work with OS2GIF in standard EGA or VGA modes.  As I
  103. gain access to additional video boards I will strive to support them in
  104. OS2GIF.  As OS/2 PM becomes a usable environment I hope to provide a PM
  105. version of OS2GIF.
  106.  
  107.  
  108. Performance
  109.  
  110.    The first version of OS2GIF (version 1.0) is written in the C language
  111. with assembler routines for the Ring 2 I/O video control.  It does not have
  112. the best performance during image display, but future versions should provide
  113. more optimization using assembler code.  I expect a two to threefold
  114. performance improvement.
  115.  
  116.                OS2GIF V1.0 User Guide               Page  2
  117.  
  118.  
  119.              INSTALLATION AND STARTING
  120.  
  121.  
  122. Installing OS2GIF
  123.  
  124.    To install OS2GIF, simply copy the OS2GIF.EXE module into a directory which
  125. is in the "PATH=" list in CONFIG.SYS.  OS2GIF is a NON PM, protected mode
  126. application; it does not execute under DOS or in the DOS compatibility
  127. session.
  128.  
  129.    Since OS2GIF requires I/O previledge, you must insure your CONFIG.SYS
  130. contains a "IOPL=YES" statement.  Optionaly you could list the OS2GIF program
  131. name on the IOPL statement.  For example, "IOPL=OS2GIF".  See your OS/2
  132. documentation for the CONFIG.SYS "IOPL" statement.
  133.  
  134.  
  135. Starting OS2GIF
  136.  
  137.    The OS/2 command line may be used to start OS2GIF.  OS2GIF is easy to use
  138. and has a help function available by pressing the F1 key.
  139.  
  140.    OS2GIF should execute in the foreground and it will lock the video display
  141. during image drawing.  This means that no other processes may "pop up" onto
  142. the video display during OS2GIF image drawing.    Currently OS/2 limits this
  143. locking to a 30 second maximum.  If after this time the display is disrupted,
  144. you must return to the selection menu and reselect the GIF file to redraw it.
  145.  
  146.    The command line may provide several options as described below:
  147.  
  148.     OS2GIF [filemask] [...] [/G] [/Q] [/L]
  149.  
  150.     The filemask is one or more standard file names with wildcards.
  151.     For example: *.* or *.GIF (the GIF is assumed if not specifed)
  152.     Also for the first filemask a drive and path may be specified.
  153.     For example, " OS2GIF D:\JAMES\PICS *.PIC *.IMG", specifies
  154.     all the "*.GIF" and "*.PIC" and "*.IMG" files in "D:\JAMES\PICS"
  155.     directory.  The default filemask of: *.GIF (current drive and
  156.     directory) is used if none is specified.
  157.  
  158.     /L will bypass the OS/2 Screen Locking.  This is used primarily
  159.     for debugging, but may be used anytime locking is inconvient.
  160.  
  161.     /G will display the GIF file information on the select menu.
  162.     Without the "/G", a normal directory listing will appear for
  163.     the selection menu.  With "/G", the GIF screen size and colors
  164.     will be read from each GIF file and appear with the file name
  165.     in the selection menu.
  166.  
  167.     /Q will provide a 'quiet' mode without beeps.
  168.  
  169.  
  170.    The OS2GIF full screen selection menu will display after reading the
  171. files specifed by the filemask.
  172.  
  173.                OS2GIF V1.0 User Guide               Page  3
  174.  
  175.  
  176.                   SELECTION MENU
  177.  
  178.  
  179.  
  180.    When OS2GIF starts it will read the directory entries for the specified
  181. filemask and display them in a full screen selection menu.  You may use the
  182. highlighted line as a cursor and position it with the up/down arrows, the
  183. left/right arrows, the PageUp/PageDown keys, and the Home/End keys.
  184.  
  185.    When you have highlighted the GIF file you wish to view, press ENTER.
  186. The GIF image will be displayed in the best fit of screen size, colors, and
  187. your video adapter.  CNTL-ENTER may be used to select a file, then prompt you
  188. to select the video display mode for the file.
  189.  
  190.    You may also key the name of the GIF file directly into the data entry
  191. field at the bottom of the screen, and press ENTER (or CNTL-ENTER) for
  192. selection.
  193.  
  194.    The following keys may be used to control OS2GIF while the selection menu
  195. is shown:
  196.  
  197.     ESC       = Exit from Menu Screen back to OS2.
  198.     Up/Down/Left/Right = Move the highlight cursor for file selection.
  199.     PgUp/PgDn  = Scroll directory list by pages.
  200.     ENTER       = Select file for display.
  201.     CNTL-ENTER = Select file for display and prompt for video mode.
  202.     F1       = Online Help Function.
  203.     F2       = Rebuild Directory List using new file mask if any.
  204.     F10       = Toggle GIF Screen data display/Directory data.
  205.     Normal ASCII keys may be used to enter a file name.
  206.  
  207.  
  208.    The F10 key may be used with the F2 key to rebuild the selection display
  209. with the GIF Screen information rather than the normal directory list.
  210.  
  211.    If a new filemask is entered in the data entry field, F2 may be pressed
  212. to use it for the selection menu.  This mask may include a drive and path.
  213.  
  214.    When the CNTL-ENTER selection is made, a menu of video modes will be shown.
  215. Simply press the number key for the video mode desired to display the GIF file.
  216.  
  217.                OS2GIF V1.0 User Guide               Page  4
  218.  
  219.  
  220.                   GIF IMAGE DISPLAY
  221.  
  222.  
  223.  
  224.    After selection of a GIF file, the video screen will be set to the video
  225. mode for the image and the drawing will begin.    During the image drawing, the
  226. CNTL-C and CNTL-BREAK keys may be used to cancel the drawing.  These are the
  227. normal OS/2 interrupt keys.
  228.  
  229.    The 256 color GIF files will require a VGA adapter for a useful display.
  230.  
  231.    GIF files with screen sizes larger than the adapter are supported.  A
  232. virtual screen is used by OS2GIF.  For the 16 color mode, the virtual screen
  233. exists in the video adapter's 256K of memory and the largest supported virtual
  234. screen size is 640 x 800.  For the 256 color modes, the virtual screen exists
  235. in OS/2 memory, and the largest supported virtual screen size is limited by
  236. OS/2's dynamic memory availability which should be larger than most GIF file
  237. images.
  238.  
  239.    When GIF file is drawn with an image larger than the physical screen,
  240. a beep will be heard at the begining and the end of the drawing process,
  241. unless the "/Q" quiet mode is specified.  The first beep lets you know panning
  242. will be available for the image.  The second beep lets you know when you may
  243. begin the panning.
  244.  
  245.    The virtual screen may be panned with the Up/Down/Left/Right arrows, the
  246. Home/End keys, the PageUp/PageDown keys, the CNTL-left/CNTL-right keys, and
  247. the CNTL-PgUp/CNTL-PgDn keys.
  248.  
  249.    After viewing the image, you may return to the selection menu by pressing
  250. the ESC key.
  251.  
  252.